home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / disk / cdrom / MCD_DirList.readme < prev   
Encoding:
Text File  |  2000-01-02  |  8.0 KB  |  244 lines
  1. Short:    Generates file lists for MakeCD
  2. Author:   amiga@rripley.de (Ralph Reuchlein)
  3. Uploader: amiga@rripley.de (Ralph Reuchlein)
  4. Version:  1.0
  5. Type:     disk/cdrom
  6. Kurz:     Erzeugt Dateilisten für MakeCD
  7. Date:     27-Dec-1999
  8.  
  9.                             MakeCD_DirList
  10.                             ==============
  11.  
  12.  
  13. PURPOSE
  14.  
  15.    Ever tried to backup a complete partition or directory on a
  16.    (re)writeable CD? You got no errors during ISO image creation? You
  17.    are a lucky one, because ...
  18.  
  19.    ... I got problems. I am using (soft) links on my partitions and
  20.    MakeCD terminates the ISO image creation if it detects a link. The
  21.    only thing I can do is building a file list without the link
  22.    entries. Thats the main purpose of this program.
  23.  
  24.    You might say 'thats no real backup, because the links are
  25.    missing!'. Yes, you are right. Unfortunately this isn't the only
  26.    problem: Files listed in file lists got no protection bits, no
  27.    timestamps for directories and no file comments in the resulting
  28.    ISO image (refer to the documentation of MakeCD if you can't
  29.    believe it). When e.g. making a backup from your YAM emails, you
  30.    will loose your mail status flags that are stored in file comments
  31.    (my AsimCDFS doesn't retrieve them).
  32.  
  33.    So I invented a separate file which is finally a AmigaDOS script
  34.    that sets the protection bits, updates the timestamps and writes
  35.    file comments. This script file is stored in the main directory you
  36.    will backup.
  37.  
  38.    You will also be warned if there are read protected files, because
  39.    MakeCD will not be able to read these files for backup. Its your
  40.    turn to change the read protection for yourself.
  41.  
  42.  
  43.  
  44. HISTORY
  45.  
  46.    v1.0:
  47.    - First Release
  48.  
  49.  
  50.  
  51. INSTALL
  52.  
  53.    Simply unpack the archive to anywhere you want. I prefer to copy
  54.    the executable to C:.
  55.  
  56.  
  57.  
  58. REQUIREMENTS
  59.  
  60.    - OS 3.0
  61.    - MakeCD if you intend to backup the listed files to CD
  62.  
  63.  
  64.  
  65. USAGE
  66.  
  67.    The template is
  68.  
  69.       STARTDIRECTORY=DIR/A,PREFIX=PRE,PROGRESSBAR=BAR/S
  70.  
  71.    You always have to provide the directory from where you want to
  72.    build up the file list. The parameter PREFIX allowes making a
  73.    subdirectory in your ISO image to avoid mixing several file lists
  74.    in one ISO image. The PREFIX parameter must have a trailing '/'
  75.    (which will not be checked at the moment)! Finally the PROGRESSBAR
  76.    switch turns on a simple directory level progress bar.
  77.  
  78.    The file list will be written to STDOUT, mainly your Shell window.
  79.    Thus you must redirect the output to a file if MakeCD should use
  80.    it. The progress bar and the final report is written to STDERR.
  81.    The additional script, created by MakeCD_DirList, will be written
  82.    in the directory specified by DIR with the filename
  83.    ".amiga_makecd_update".
  84.  
  85.    The generated script can contain the usual SETDATE, PROTECT,
  86.    FILENOTE and MAKELINK commands. It depends on the files and
  87.    directories:
  88.  
  89.       SETDATE
  90.          set only for directories, because MakeCD handles file entries
  91.          correctly
  92.       PROTECT
  93.          always set for directories and only set for files if other
  94.          flags as RWED are used
  95.       FILENOTE
  96.          always set for files and directories
  97.       MAKELINK
  98.          always set for each found link. Broken links are stored too,
  99.          but they were commented out by ';'. To search for them,
  100.          simply use SEARCH with the keyword ";MAKELINK".
  101.  
  102.    If you intend to backup the CD data to another directory, you
  103.    simply need to copy the full data to that directory and call the
  104.    script .amiga_makecd_update in this directory. Thats all.
  105.  
  106.  
  107.  
  108. EXAMPLE
  109.  
  110.    I want to backup my YAM directory to CD:
  111.  
  112.       MakeCD_DirList YAM: YAM/ >ram:YAM_directory
  113.  
  114.    This would scan YAM: and its subdirectories. The 'YAM/' is the
  115.    prefix for the resulting ISO image, that means every scanned entry
  116.    is located in a directory called YAM on CD. Finally the file list
  117.    for MakeCD is redirected to ram:YAM_directory.
  118.  
  119.    After processing the above example would return in the Shell
  120.    window:
  121.  
  122.       45 dirs (2 empty),
  123.       3509 files (0 read protected, 95421168 bytes),
  124.       1 good and 0 bad links processed (0 unknown).
  125.  
  126.    The file ".amiga_makecd_update" in the directory YAM: now contains
  127.    for example:
  128.  
  129.       SETDATE  "log" 01-Dez-99  19:55:56
  130.       SETDATE  "Draft" 25-Dez-99  16:06:06
  131.       SETDATE  "Icons_PL" 10-Jul-99  13:19:02
  132.       FILENOTE "Icons_PL/YAMPLIcons.readme" "YAM Prolite Icons"
  133.       SETDATE  "Catalogs" 11-Jun-99  16:52:01
  134.       SETDATE  "Catalogs/deutsch" 10-Jul-99  13:10:56
  135.       SETDATE  "Icons_NI" 10-Jul-99  13:20:19
  136.       MAKELINK "Icons" "INTERNET:Programme/YAM/Icons_NI" SOFT
  137.       SETDATE  "Icons_MWB" 25-Apr-99  12:30:38
  138.       FILENOTE "Icons_MWB/status_group" "Mario Cattaneo <cattaneo@CoLi.Uni-SB.DE>"
  139.       ...
  140.       SETDATE  "news" 25-Apr-99  12:31:38
  141.       SETDATE  "misc" 25-Dez-99  19:12:26
  142.       PROTECT  "misc/look4mail.sh" srwed
  143.       PROTECT  "misc/correctAddress.sh" srwd
  144.       PROTECT  "misc/viewLhA.sh" srwd
  145.       SETDATE  "temp" 27-Dez-99  10:23:19
  146.  
  147.    The resulting file list file ram:YAM_directory contains for
  148.    example:
  149.  
  150.       INTERNET:Programme/YAM/log/YAM-Dec1999.log::YAM/log/YAM-Dec1999.log
  151.       INTERNET:Programme/YAM/log/YAM-Jan1999.log::YAM/log/YAM-Jan1999.log
  152.       INTERNET:Programme/YAM/log/YAM-Feb1999.log::YAM/log/YAM-Feb1999.log
  153.       ...
  154.       INTERNET:Programme/YAM/.folders::YAM/.folders
  155.       INTERNET:Programme/YAM/YAM20P6.lha::YAM/YAM20P6.lha
  156.       INTERNET:Programme/YAM/YAM20P7.lha::YAM/YAM20P7.lha
  157.       INTERNET:Programme/YAM/arexx_commands.txt.info::YAM/arexx_commands.txt.info
  158.       INTERNET:Programme/YAM/temp::YAM/temp
  159.  
  160.    This file is used for MakeCD to generate the ISO image.
  161.  
  162.    Remember: You have to make read protected files readable for
  163.    MakeCD, because MakeCD doesn't change anything on files and
  164.    directories. Avoid backupping image files MakeCD generates, because
  165.    they are in use by MakeCD and can't be read by it for ISO image
  166.    creation.
  167.  
  168.  
  169.    If you want to copy the CD contents to another directory some years
  170.    later, you simply need to copy the CD directory to destination
  171.    with:
  172.  
  173.       copy CD0:YAM SOMEWHERE: clone
  174.  
  175.    After that change to the destination directory
  176.  
  177.       cd SOMEWHERE:
  178.  
  179.    and then call
  180.  
  181.       execute .amiga_makecd_update
  182.  
  183.    Finished.
  184.  
  185.  
  186.  
  187. BUGS
  188.  
  189.    At the moment there is none I believe and bug reports are always
  190.    welcome.
  191.  
  192.  
  193.  
  194. DISCLAIMER
  195.  
  196.    THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS"
  197.    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  198.    TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  199.    PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR
  200.    CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  201.    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  202.    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  203.    USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  204.    ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  205.    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  206.    OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  207.    SUCH DAMAGE.
  208.  
  209.  
  210.  
  211. MISC
  212.  
  213.    Suggestions and bug reports are welcome. I am going to improve the
  214.    little tool with some more preferences like deny lists (directories
  215.    that should not be backuped) and so on. Be patient.
  216.  
  217.    I have added the source to the archive. Feel free to use the code
  218.    unless my copyright notice always is attached to.
  219.  
  220.  
  221.  
  222. CONTACT
  223.  
  224.    snail  Ralph Reuchlein
  225.    mail:  Eibseestr. 18c
  226.           86163 Augsburg
  227.           GERMANY
  228.    
  229.    eMail: amiga@rripley.de
  230.    WWW:   http://www.rripley.de
  231.    IRC:   RRipley on #germany
  232.  
  233.  
  234. ============================= Archive contents =============================
  235.  
  236. Original  Packed Ratio    Date     Time    Name
  237. -------- ------- ----- --------- --------  -------------
  238.      124      89 28.2% 05-Dec-99 17:39:02  SCOPTIONS
  239.    14580    9256 36.5% 28-Dec-99 11:10:44  MakeCD_DirList
  240.    10346    2792 73.0% 28-Dec-99 11:10:38  MakeCD_DirList.c
  241.     7690    3280 57.3% 28-Dec-99 11:20:12  MCD_DirList.readme
  242. -------- ------- ----- --------- --------
  243.    32740   15417 52.9% 29-Dec-99 01:42:16   4 files
  244.